home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / fse_332.zip / MARKET-D.ZIP / FSE.DOC < prev    next >
Text File  |  1989-10-09  |  16KB  |  404 lines
  1.  
  2. File list:
  3. ==========
  4.  
  5. This document is a simple instruction to use to setup The Fictitious
  6. Stock Exchange for your RBBS.  The following files are included:
  7.  
  8.           FSE.DOC     -  This Document
  9.           MARKET.DOC  -  Player documentation (make it downloadable)
  10.           MARKET.BAT  -  DOORS execution file (sample)
  11.           MARKET.EXE  -  The executible program (will run stand-alone)
  12.           MARKET.CFG  -  Configuration file
  13.           MARKET.NEW  -  New user instructions
  14.           MARKET.TTN  -  Title screen (no graphics)
  15.           MARKET.TTI  -  Title screen (ASCII graphics)
  16.           MARKET.TTC  -  Title screen (ANSI graphics)
  17.  
  18.           MARKET.DAT  -  Market data (created by program)
  19.           MARKET.PLR  -  Players records file (created by program)
  20.           MARKET.ERR  -  Error & editor access record (created by program)
  21.  
  22.           NODES.BBS   -  A list of your comm port assignments by BBS node
  23.           TIMEGEN.EXE -  Time control file generator
  24.           TIMES.DEF   -  Sample time control file
  25.           MARKET.TIM  -  Compiled time controls
  26.  
  27.  
  28. Program history:
  29. ================
  30.  
  31. 7/87    Version P.xx  -  Preliminary.
  32. 8/87    Version 1.00  -  Few bug fixes.
  33.                          Corrected most typos & spelling errors.
  34.                          Added CHAT support.
  35.                          More cases added.
  36. 9/87    Version 1.10  -  Set up default responses to Y/N questions.
  37.                          Support for time controls.
  38.                          Support for SNP, ANY, AVL toggles.
  39.                          Will run under door monitor.
  40. 11/87   Version 2.00  -  Support for PC-BOARD BBS
  41.                          Support for multi-tasking (SHARE)
  42. 03/88   Version 2.02  -  Bug fixes to shared file access
  43. 04/88   Version 2.03  -  RBBS 16.1A & WILDCAT BBS support
  44. 06/88   Version 2.04  -  Quick BBS support
  45.                          New GMON monitor spec support
  46. 07/88   Version 2.05  -  TIMEGEN interface repaired
  47.                          New SysOp keys added
  48.                          Word Wrap added in CHAT
  49. 08/88   Version 2.06  -  Shared file access bug fix
  50.                          GAP BBS support added
  51. 11/88   Version 2.07  -  PCBoard 14.0 support added
  52.                          WWIV BBS support added
  53. 02/89   Version 2.08  -  PCBoard 14.0 support bug fix
  54. 03/89   Version 3.00  -  ANSI menu version
  55.                          Player & company editor
  56. 09/89   Version 3.12  -  Spitfire support
  57. 10/89   Version 3.20  -  Local login support
  58.  
  59.  
  60. Configuration File:
  61. ===================
  62.  
  63. The configuration file consists of 5 lines of text.  The following is a
  64. sample configuration file with comments about what each line contains.  The
  65. actual configuration file should not have any comments.
  66.  
  67. Mycroft Systems         ; Name of BBS system
  68. MARKET.DOC              ; Name of documentation file
  69. C:\RBBS\BULLET10        ; Name of output bulletin
  70. MIKE BAYLEY             ; User login name of person allowed remote editor access
  71. Mycroft                 ; Password to enter editor
  72.  
  73.  
  74. Executing Market:
  75. =================
  76.  
  77. To execute directly as a door, you can use the file MARKET.BAT.  The
  78. program must be executed from the directory containing all of the
  79. above listed files except that NODES.BBS must be in the RBBS directory.
  80. Note that MARKET will not currently run properly under the Door Monitor.
  81.  
  82. Market is invoked on of four ways.
  83.  
  84.         1. MARKET
  85.         2. MARKET node
  86.         3. MARKET node path
  87.         4. MARKET node path bbs
  88.  
  89. The first is used to run Market in local mode.  This will play as any
  90. other game on your IBM PC.  The second method is used to run Market
  91. under the door monitor.  The node parameter is automatically supplied by
  92. the door monitor itself.  The third method is used when running as a
  93. door under RBBS.  The path parameter is the current full path containing
  94. the RBBS configuration files.  The node is the RBBS node number.  The
  95. node number is passed to door batch files as parameter 1.  The fourth
  96. method may be used for either RBBS or PC-BOARD.  The fourth parameter is
  97. used to specify the BBS type.  Set this to:
  98.  
  99.         (empty)         for RBBS 15.x
  100.         RBBS            for RBBS 16.x
  101.         QBBS            for Quick BBS
  102.         PCBOARD         for PC-Board BBS 12.1
  103.         PCBOARD14       for PC-Board BBS 14.0
  104.         WILDCAT         for Wildcat BBS
  105.         GAP             for GAP BBS
  106.         WWIV            for WWIV BBS
  107.         SPITFIRE        for Spitfire BBS (Door)
  108.         SPITFIREK       for Spitfire BBS (Main menu cmd)
  109.         SPITFIREM       for Spitfire BBS (Msg. menu cmd)
  110.         SPITFIREF       for Spitfire BBS (File menu cmd)
  111.  
  112.  
  113. Assumed RBBS 16.x files:
  114. ========================
  115.  
  116. Market assumes that the following files are in the directory specified
  117. by the path parameter when running directly under RBBS 16.x:
  118.  
  119.         NODES.BBS       Node definition file.
  120.  
  121.         MESSAGES        This file contains the information pertaining
  122.                         to each node on the BBS.
  123.  
  124.         DORINFOx.DEF    This file contains all of the users settings
  125.                         such as graphics, parity, baud rate, etc.
  126.  
  127.  
  128. Assumed RBBS 15.x files:
  129. ========================
  130.  
  131. Market assumes that the following files are in the directory specified
  132. by the path parameter when running directly under RBBS 15.x:
  133.  
  134.         NODES.BBS       Node definition file.
  135.  
  136.         MESSAGES        This file contains the information pertaining
  137.                         to each node on the BBS.
  138.  
  139.         USERS           This file contains all of the users settings
  140.                         such as graphics, parity, baud rate, etc.
  141.  
  142.         PASSWRDS        This file MUST contain an entry for each security
  143.                         level allowed to run doors.  Market gets the
  144.                         users daily time limit from this file.
  145.  
  146.  
  147. Assumed Quick BBS files:
  148. ========================
  149.  
  150. Market assumes that the following files are in the directory specified
  151. by the path parameter when running directly under Quick BBS:
  152.  
  153.         NODES.BBS       Node definition file.
  154.  
  155.         DORINFOx.DEF    This file contains all of the users settings
  156.                         such as graphics, parity, baud rate, etc.
  157.  
  158.  
  159. Assumed PC-BOARD files:
  160. =======================
  161.  
  162. Market assumes that the following files are in the directory specified
  163. by the path parameter when running directly under PC-Board:
  164.  
  165.         NODES.BBS       Node definition file.
  166.  
  167.         PCBOARD.SYS     This file contains the information pertaining
  168.                         to the BBS node and the callers information.
  169.  
  170.  
  171.  
  172. Assumed Wildcat files:
  173. ======================
  174.  
  175. Market assumes that the following files are in the directory specified
  176. by the path parameter when running directly under Wildcat:
  177.  
  178.         NODES.BBS       Node definition file.
  179.  
  180.         CALLINFO.BBS    This file contains all of the users settings
  181.                         such as graphics, parity, baud rate, etc.
  182.  
  183.  
  184.  
  185. Assumed GAP files:
  186. ==================
  187.  
  188. Market assumes that the following files are in the directory specified
  189. by the path parameter when running directly under GAP BBS:
  190.  
  191.         NODES.BBS       Node definition file.
  192.  
  193.         DOOR.SYS        This file contains all of the users settings
  194.                         such as graphics, parity, baud rate, etc.
  195.  
  196.  
  197.  
  198. Assumed WWIV files:
  199. ===================
  200.  
  201. Market assumes that the following files are in the directory specified
  202. by the path parameter when running directly under WWIV BBS:
  203.  
  204.         NODES.BBS       Node definition file.
  205.  
  206.         CHAIN.TXT       This file contains all of the users settings
  207.                         such as graphics, parity, baud rate, etc.
  208.  
  209.  
  210.  
  211. Assumed Spitfire files:
  212. =======================
  213.  
  214. Market assumes that the following files are in the directory specified
  215. by the path parameter when running directly under Spitfire BBS:
  216.  
  217.         NODES.BBS       Node definition file.
  218.  
  219.       * SFDOORS.DAT     This file contains all of the users settings
  220.                         such as graphics, parity, baud rate, etc.
  221.  
  222.       * SFMAIN.DAT      This file contains all of the users settings
  223.                         such as graphics, parity, baud rate, etc.
  224.  
  225.       * SFMESS.DAT      This file contains all of the users settings
  226.                         such as graphics, parity, baud rate, etc.
  227.  
  228.       * SFFILE.DAT      This file contains all of the users settings
  229.                         such as graphics, parity, baud rate, etc.
  230.  
  231. * Note only one of these files is required.  Which one depends on which
  232. install option is selected.
  233.  
  234.  
  235. Assumed Monitor files:
  236. ======================
  237.  
  238. Market assumes that the following files are in the local directory with
  239. the game when running under an RBBS monitor:
  240.  
  241.         NODES.BBS       Node definition file.
  242.  
  243.         TIMEOFFx.DOR    This file contains all of the users settings
  244.                         such as graphics, parity, baud rate, etc.
  245.  
  246.  
  247. Market assumes that the following files are in directory specified in the
  248. path parameter of the TIMEOFFx.DOR file:
  249.  
  250.         USERS.DOR       Monitor users file.
  251.  
  252.         MONITOR1.EXE    This file will be executed when the program
  253.                         terminates.
  254.  
  255.  
  256. Market will build the following files are in the local directory with
  257. the game when running under an RBBS monitor:
  258.  
  259.         POINTSx.DOR     This file contains returns the amount of time
  260.                         used in the game and a Monitor score value.
  261.  
  262.  
  263.  
  264. Adding time controls:
  265. =====================
  266.  
  267. With version 1.10 and newer, Market contains the ability to control access
  268. of the game by security level, time of day, total play time per day, total
  269. play time per game, total game count per day, and time required to wait
  270. in between games.
  271.  
  272. The time control file may be used directly under RBBS or also with the door
  273. monitor.  If not included, then only the standard time controls are used.
  274.  
  275. The time definition file is an ASCII file used to create the time control
  276. data file.  It has the following format:
  277.  
  278. :SYSOP 1000 2330                                         ; Sysops hours
  279. :LEVEL  006  007  008  008  008  008  008  008           ; Level access classes
  280. :DAYT   000  000  000  000  000  000  000  000           ; Daily time limits
  281. :DAYG   001  002  003  003  003  003  003  003           ; Daily game limits
  282. :WAIT   000  030  030  000  000  000  000  000           ; Time between games
  283. :TIME  0000  060  060  060  060  060  060  060  120      ; Per game access
  284. :TIME  0600  000  030  030  030  030  030  030  030      ; Per game access
  285. :TIME  1000  000  045  045  045  045  045  045  120      ; Per game access
  286. :TIME  1600  000  030  030  030  030  030  030  030      ; Per game access
  287. :TIME  2000  000  045  045  045  045  045  045  060      ; Per game access
  288.  
  289. The first entry defines the SysOp hours.  This controls when the player may
  290. use the page command.  These entires are expressed as HHMM.  The second entry
  291. may be smaller than the first.  As an example, ":SYSOP 0700 1900" allows the
  292. player to use the page command from 7am until 7pm.  The entry ":SYSOP 2200
  293. 0200" allows the page command to be used between 10pm and 2am.
  294.  
  295. The ":LEVEL" entry defines how different security level users have access to
  296. the game.  This line consists of 8 entries in ascending order.  Each entry
  297. corresponds to a game control level.  As an example let us consider the
  298. following entry: ":LEVEL 010 020 030 040 050 060 070 080".  Any user with
  299. a security level of less than 10 would not have access to the game.  Users
  300. with security level 10 through 19 would have level 0 privelidges.  Users
  301. with security level 20 through 29 would have level 1 privelidges, etc.
  302. Priveledges are explained below.
  303.  
  304. The ":DAYT" entry defines the maximum time in minutes each privelidge level
  305. may play the game per day.  This entry consists of 8 values each corresponding
  306. to a privelidge level in ascending order.  Each value is in minutes.  A value
  307. of 0 represents no daily time limit for that particular privelidge level.
  308.  
  309. The ":DAYG" entry defines the maximum number of times the user may enter the
  310. game on a gien day.  It consists of 8 values each corresponding to a
  311. privelidge level in ascending order.  A value of 0 represents no game limit
  312. for that particular privelidge level.
  313.  
  314. The ":WAIT" entry defines the amount of time in minutes each user must
  315. wait between entering the game.  This entry consists of 8 values each
  316. corresponding to a privelidge level in ascending order.
  317.  
  318. The ":TIME" entries define the amount of time each user may spend during a
  319. single play session.  It consists of 9 values.  The first is the time of
  320. day the period starts.  The remaining 8 are the game time limits for
  321. each of the 8 privelidge levels.  Time limits are in minutes.  A 0 value
  322. here means that the user my not play the game during that time period.
  323. Each ":TIME" entry must be in ascending time of day order.  There may be
  324. a maximum of 8 ":TIME" entries.
  325.  
  326. To build the time control file, the following command line is used:
  327.  
  328.                 TIMEGEN def_file time_file
  329.  
  330. Where def_file is the ASCII file defining all time controls and time_file
  331. is the output file that the game will read.  For Market, use the following
  332. command line:
  333.  
  334.                 TIMEGEN times.def market.tim
  335.  
  336.  
  337. Deleting old players:
  338. =====================
  339.  
  340. Old players are automatically deleted by Market after 30 days of inactivity.
  341.  
  342.  
  343. Editor controls:
  344. ================
  345.  
  346.                               [Remote Editor Menu]
  347.  
  348.      [^Q] Exit and abort      [^K] Cursor up          [^BS] Delete previous
  349.      [^Z] Exit and save       [^J] Cursor down         [^G] Delete current
  350.      [^R] Previous page       [^H] Cursor left         [^O] Delete to EOL
  351.      [^V] Next page           [^L] Cursor right        [^Y] Delete line
  352.      [^B] Begin/end line      [^A] Previous word       [^N] Insert new line
  353.      [^T] Top/bottom page     [^D] Next word           [^F] Insert/replace
  354.  
  355.  
  356. SysOp controls:
  357. ===============
  358.  
  359. The SysOp has similar controls as to those provided in RBBS.  The following
  360. set of functions are available:
  361.  
  362.     Alt F1      This key will eject a user from the game by
  363.                 setting all his time to consumed.
  364.  
  365.     Right Arrow This key will add one minute of game time to
  366.                 the current users current game session.
  367.  
  368.     Left Arrow  This key will subtract one minute of game time
  369.                 from the current users current game session.
  370.  
  371.         F4      The F4 key will toggle the state of the SysOp
  372.                 annoy toggle.  Note that it is reset to its
  373.                 original state when RBBS is reentered.
  374.  
  375.         F6      The F6 key will toggle the state of the SysOp
  376.                 availability toggle.  Note that it is reset to
  377.                 its original state when RBBS is reentered.
  378.  
  379.         F9      The F9 key will toggle the state of the SysOp
  380.                 snoop toggle.  Note that it is reset to its
  381.                 original state when RBBS is reentered.
  382.  
  383.         F10     The F10 key is used to initiate CHAT mode.  This
  384.                 allows the SysOp to converse with the user via the
  385.                 keyboard.  Unlike RBBS, CHAT mode in Market does
  386.                 not support word wrap and you will need to hit the
  387.                 ENTER key ate the end of each line.
  388.  
  389.         ESC     The escape key is used to answer a user page.  It
  390.                 is also used to terminate CHAT mode.
  391.  
  392.  
  393. Epilog:
  394. =======
  395.  
  396. Please enjoy the program and share your ideas with me.
  397.  
  398.                                                 Thanks,
  399.  
  400.                                                 Michael W. Bayley
  401.                                                 Mycroft Systems
  402.                                                 (408)927-0105
  403.  
  404.